| Top | |
|
|
|
| gboolean | follow-state | Read / Write / Construct |
| GIcon * | gicon | Read / Write |
| char * | icon | Read / Write |
| int | size | Read / Write / Construct |
An XfceCellRendererIcon can be used to render an icon in a cell. It allows to render either a named icon, which is looked up using the GtkIconTheme, or an image file loaded from the file system. The icon name or absolute path to the image file is set via the XfceCellRendererIcon:icon property.
To support the XfceIconView (and GtkIconView) XfceCellRendererIcon supports rendering icons based on the state of the view if the XfceCellRendererIcon:follow-state property is set.
GtkCellRenderer *
xfce_cell_renderer_icon_new (void);
Creates a new XfceCellRendererIcon. Adjust rendering parameters using object properties,
which can be set globally via g_object_set(). Also, with GtkCellLayout and
GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example
you can bind the XfceCellRendererIcon:icon property on the
cell renderer to an icon name in the model, thus rendering a different icon in each row
of the GtkTreeView.
Since: 4.21.0
typedef struct _XfceCellRendererIcon XfceCellRendererIcon;
The XfceCellRendererIcon struct contains only private fields and should not be directly accessed.
Since: 4.21.0
“follow-state” property “follow-state” gboolean
Specifies whether the icon renderer should render icon based on the selection state of the items. This is necessary for XfceIconView, which doesn't draw any item state indicators itself.
Owner: XfceCellRendererIcon
Flags: Read / Write / Construct
Default value: TRUE
Since: 4.21.0
“gicon” property “gicon” GIcon *
The GIcon to render. May also be NULL in which case no icon will be
rendered for the cell.
Currently only GThemedIcons are supported which are loaded using the current icon theme.
Owner: XfceCellRendererIcon
Flags: Read / Write
Since: 4.21.0
“icon” property “icon” char *
The name of the themed icon to render or an absolute path to an image file
to render. May also be NULL in which case no icon will be rendered for the
cell.
Image files are loaded via the thumbnail database, creating a thumbnail as necessary. The thumbnail database is also used to load scalable icons in the icon theme, because loading scalable icons is quite expensive these days.
Owner: XfceCellRendererIcon
Flags: Read / Write
Default value: NULL
Since: 4.21.0
“size” property “size” int
The size in pixel at which to render the icon. This is also the fixed size that the renderer will request no matter if the actual icons are smaller than this size.
This improves the performance of the layouting in the icon and tree view, because during the layouting phase no icons will need to be loaded, but the icons will only be loaded when they need to be rendered, i.e. the view scrolls to the cell.
Owner: XfceCellRendererIcon
Flags: Read / Write / Construct
Allowed values: >= 1
Default value: 48
Since: 4.21.0